home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qfont.Z / qfont
Encoding:
Text File  |  1998-10-28  |  47.3 KB  |  859 lines

  1.  
  2.  
  3.  
  4.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       QFont    - Font used for    drawing    text
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <qfont.h>
  13.  
  14.     PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  15.       eeeennnnuuuummmm SSSSttttyyyylllleeeeHHHHiiiinnnntttt {{{{ HHHHeeeellllvvvveeeettttiiiiccccaaaa,,,, TTTTiiiimmmmeeeessss,,,, CCCCoooouuuurrrriiiieeeerrrr,,,, OOOOllllddddEEEEnnnngggglllliiiisssshhhh,,,,
  16.           SSSSyyyysssstttteeeemmmm,,,, AAAAnnnnyyyySSSSttttyyyylllleeee,,,,    SSSSaaaannnnssssSSSSeeeerrrriiiiffff ==== HHHHeeeellllvvvveeeettttiiiiccccaaaa,,,, SSSSeeeerrrriiiiffff ==== TTTTiiiimmmmeeeessss,,,,
  17.           TTTTyyyyppppeeeeWWWWrrrriiiitttteeeerrrr ==== CCCCoooouuuurrrriiiieeeerrrr,,,, DDDDeeeeccccoooorrrraaaattttiiiivvvveeee ==== OOOOllllddddEEEEnnnngggglllliiiisssshhhh}}}}
  18.       eeeennnnuuuummmm WWWWeeeeiiiigggghhhhtttt {{{{    LLLLiiiigggghhhhtttt ====    22225555,,,, NNNNoooorrrrmmmmaaaallll ==== 55550000,,,, DDDDeeeemmmmiiiiBBBBoooolllldddd ==== 66663333,,,,    BBBBoooolllldddd ====
  19.           77775555,,,, BBBBllllaaaacccckkkk    ==== 88887777 }}}}
  20.       eeeennnnuuuummmm CCCChhhhaaaarrrrSSSSeeeetttt {{{{ LLLLaaaattttiiiinnnn1111,,,, IIIISSSSOOOO____8888888855559999____1111 ==== LLLLaaaattttiiiinnnn1111,,,, AAAAnnnnyyyyCCCChhhhaaaarrrrSSSSeeeetttt,,,,
  21.           LLLLaaaattttiiiinnnn2222,,,, IIIISSSSOOOO____8888888855559999____2222 ==== LLLLaaaattttiiiinnnn2222,,,, LLLLaaaattttiiiinnnn3333,,,, IIIISSSSOOOO____8888888855559999____3333 ====
  22.           LLLLaaaattttiiiinnnn3333,,,, LLLLaaaattttiiiinnnn4444,,,, IIIISSSSOOOO____8888888855559999____4444 ==== LLLLaaaattttiiiinnnn4444,,,, LLLLaaaattttiiiinnnn5555,,,, IIIISSSSOOOO____8888888855559999____5555
  23.           ====    LLLLaaaattttiiiinnnn5555,,,,    LLLLaaaattttiiiinnnn6666,,,,    IIIISSSSOOOO____8888888855559999____6666 ====
  24.       QQQQFFFFoooonnnntttt    (((())))
  25.       QQQQFFFFoooonnnntttt    (((( ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** _f_a_m_i_l_y,,,, iiiinnnntttt _p_o_i_n_t_S_i_z_e ==== 11112222,,,, iiiinnnntttt _w_e_i_g_h_t
  26.       QQQQFFFFoooonnnntttt    (((( ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** _f_a_m_i_l_y,,,, iiiinnnntttt _p_o_i_n_t_S_i_z_e,,,, iiiinnnntttt _w_e_i_g_h_t
  27.       QQQQFFFFoooonnnntttt    (((( ccccoooonnnnsssstttt    QQQQFFFFoooonnnntttt &&&&    ))))
  28.       vvvviiiirrrrttttuuuuaaaallll ~~~~QQQQFFFFoooonnnntttt ()
  29.       QQQQFFFFoooonnnntttt&&&& ooooppppeeeerrrraaaattttoooorrrr==== (((( ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& ))))
  30.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** ffffaaaammmmiiiillllyyyy (((())))    ccccoooonnnnsssstttt
  31.       vvvvooooiiiidddd sssseeeettttFFFFaaaammmmiiiillllyyyy (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    ))))
  32.       iiiinnnntttt ppppooooiiiinnnnttttSSSSiiiizzzzeeee    (((()))) ccccoooonnnnsssstttt
  33.       vvvvooooiiiidddd sssseeeettttPPPPooooiiiinnnnttttSSSSiiiizzzzeeee (((( iiiinnnntttt ))))
  34.       iiiinnnntttt wwwweeeeiiiigggghhhhtttt (((())))    ccccoooonnnnsssstttt
  35.       vvvvooooiiiidddd sssseeeettttWWWWeeeeiiiigggghhhhtttt (((( iiiinnnntttt ))))
  36.       bbbboooooooollll bbbboooolllldddd (((()))) ccccoooonnnnsssstttt
  37.       vvvvooooiiiidddd sssseeeettttBBBBoooolllldddd (((( bbbboooooooollll ))))
  38.       bbbboooooooollll iiiittttaaaalllliiiicccc (((()))) ccccoooonnnnsssstttt
  39.       vvvvooooiiiidddd sssseeeettttIIIIttttaaaalllliiiicccc (((( bbbboooooooollll    ))))
  40.       bbbboooooooollll uuuunnnnddddeeeerrrrlllliiiinnnneeee (((()))) ccccoooonnnnsssstttt
  41.       vvvvooooiiiidddd sssseeeettttUUUUnnnnddddeeeerrrrlllliiiinnnneeee (((( bbbboooooooollll ))))
  42.       bbbboooooooollll ssssttttrrrriiiikkkkeeeeOOOOuuuutttt (((()))) ccccoooonnnnsssstttt
  43.       vvvvooooiiiidddd sssseeeettttSSSSttttrrrriiiikkkkeeeeOOOOuuuutttt (((( bbbboooooooollll ))))
  44.       bbbboooooooollll ffffiiiixxxxeeeeddddPPPPiiiittttcccchhhh (((()))) ccccoooonnnnsssstttt
  45.       vvvvooooiiiidddd sssseeeettttFFFFiiiixxxxeeeeddddPPPPiiiittttcccchhhh (((( bbbboooooooollll ))))
  46.       SSSSttttyyyylllleeeeHHHHiiiinnnntttt ssssttttyyyylllleeeeHHHHiiiinnnntttt (((()))) ccccoooonnnnsssstttt
  47.       vvvvooooiiiidddd sssseeeettttSSSSttttyyyylllleeeeHHHHiiiinnnntttt (((( SSSSttttyyyylllleeeeHHHHiiiinnnntttt    ))))
  48.       CCCChhhhaaaarrrrSSSSeeeetttt cccchhhhaaaarrrrSSSSeeeetttt (((()))) ccccoooonnnnsssstttt
  49.       vvvvooooiiiidddd sssseeeettttCCCChhhhaaaarrrrSSSSeeeetttt (((( CCCChhhhaaaarrrrSSSSeeeetttt ))))
  50.       bbbboooooooollll rrrraaaawwwwMMMMooooddddeeee (((()))) ccccoooonnnnsssstttt
  51.       vvvvooooiiiidddd sssseeeettttRRRRaaaawwwwMMMMooooddddeeee (((( bbbboooooooollll ))))
  52.       bbbboooooooollll eeeexxxxaaaaccccttttMMMMaaaattttcccchhhh (((()))) ccccoooonnnnsssstttt
  53.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr======== (((( ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt    &&&& )))) ccccoooonnnnsssstttt
  54.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr!!!!==== (((( ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt    &&&& )))) ccccoooonnnnsssstttt
  55.       bbbboooooooollll iiiissssCCCCooooppppyyyyOOOOffff    (((( ccccoooonnnnsssstttt    QQQQFFFFoooonnnntttt &&&&    )))) ccccoooonnnnsssstttt
  56.       HHHHAAAANNNNDDDDLLLLEEEE hhhhaaaannnnddddlllleeee    (((( HHHHAAAANNNNDDDDLLLLEEEE====0000 )))) ccccoooonnnnsssstttt
  57.       QQQQSSSSttttrrrriiiinnnngggg kkkkeeeeyyyy (((()))) ccccoooonnnnsssstttt
  58.  
  59.     SSSSttttaaaattttiiiicccc PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  60.  
  61.  
  62.  
  63.      PPPPaaaaggggeeee 1111                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  71.  
  72.  
  73.  
  74.       ccccoooonnnnsssstttt    QQQQFFFFoooonnnntttt&&&& ddddeeeeffffaaaauuuullllttttFFFFoooonnnntttt (((())))
  75.       vvvvooooiiiidddd sssseeeettttDDDDeeeeffffaaaauuuullllttttFFFFoooonnnntttt ((((    ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& ))))
  76.       ccccoooonnnnsssstttt    cccchhhhaaaarrrr**** ssssuuuubbbbssssttttiiiittttuuuutttteeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    ffffaaaammmmiiiillllyyyyNNNNaaaammmmeeee ))))
  77.       vvvvooooiiiidddd iiiinnnnsssseeeerrrrttttSSSSuuuubbbbssssttttiiiittttuuuuttttiiiioooonnnn (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****,,,, ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** ))))
  78.       vvvvooooiiiidddd rrrreeeemmmmoooovvvveeeeSSSSuuuubbbbssssttttiiiittttuuuuttttiiiioooonnnn (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ))))
  79.       vvvvooooiiiidddd lllliiiissssttttSSSSuuuubbbbssssttttiiiittttuuuuttttiiiioooonnnnssss (((( QQQQSSSSttttrrrrLLLLiiiisssstttt **** ))))
  80.       vvvvooooiiiidddd iiiinnnniiiittttiiiiaaaalllliiiizzzzeeee (((())))
  81.       vvvvooooiiiidddd cccclllleeeeaaaannnnuuuupppp (((())))
  82.       vvvvooooiiiidddd ccccaaaacccchhhheeeeSSSSttttaaaattttiiiissssttttiiiiccccssss (((())))
  83.  
  84.     PPPPrrrrooootttteeeecccctttteeeedddd MMMMeeeemmmmbbbbeeeerrrrssss
  85.       bbbboooooooollll ddddiiiirrrrttttyyyy (((())))    ccccoooonnnnsssstttt
  86.       QQQQSSSSttttrrrriiiinnnngggg ddddeeeeffffaaaauuuullllttttFFFFaaaammmmiiiillllyyyy    (((()))) ccccoooonnnnsssstttt
  87.       QQQQSSSSttttrrrriiiinnnngggg llllaaaassssttttRRRReeeessssoooorrrrttttFFFFaaaammmmiiiillllyyyy (((()))) ccccoooonnnnsssstttt
  88.       QQQQSSSSttttrrrriiiinnnngggg llllaaaassssttttRRRReeeessssoooorrrrttttFFFFoooonnnntttt (((()))) ccccoooonnnnsssstttt
  89.       iiiinnnntttt ddddeeeecccciiiiPPPPooooiiiinnnnttttSSSSiiiizzzzeeee (((()))) ccccoooonnnnsssstttt
  90.  
  91.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  92.       (Note    that these are not member functions.)
  93.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& _f))))
  94.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, QQQQFFFFoooonnnntttt &&&& _f))))
  95.  
  96.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  97.       The QFont class specifies a font used    for drawing text.
  98.  
  99.       QFont, more precisely, is a collection of attributes of a
  100.       font.    When Qt    needs to draw text, it will look up and    load
  101.       the closest matching installed font and draw using that.
  102.  
  103.       The most important attributes    of a QFont are family, point
  104.       size,    weight and italic. There are QFont constructors    that
  105.       take these attributes    as arguments, as shown in this
  106.       example:
  107.  
  108.           void MyWidget::paintEvent( QPaintEvent * )
  109.           {
  110.           QPainter p( this );
  111.           // times, 12pt, normal
  112.           p.setFont( QFont( "times" ) );
  113.           p.drawText( 10, 20, "Text1" );
  114.           // helvetica,    18pt, normal
  115.           p.setFont( QFont( "helvetica", 18 ) );
  116.           p.drawText( 10, 120, "Text2" );
  117.           // courier, 24pt, bold
  118.           p.setFont( QFont( "courier", 24, QFont::Bold ) );
  119.           p.drawText( 10, 220, "Text3" );
  120.           // lucida, 36pt, bold, italic
  121.           p.setFont( QFont( "lucida", 36, QFont::Bold, TRUE ) );
  122.           p.drawText( 10, 320, "Text4" );
  123.           }
  124.  
  125.       The default QFont constructor    makes a    copy of    the default
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 9/22/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  137.  
  138.  
  139.  
  140.       font.
  141.  
  142.       You can also change these attributes of an existing QFont
  143.       object using functions such as setFamily(), setPointSize(),
  144.       setWeight() and setItalic().
  145.  
  146.       There    are also some less-used    attributes. setUnderline()
  147.       decides whether the font is underlined or not;
  148.       setStrikeOut() can be    used to    get overstrike (a horizontal
  149.       line through the middle of the characters); setFixedPitch()
  150.       determines whether Qt    should give preference to fixed-pitch
  151.       or variable-pitch fonts when it needs    to choose an installed
  152.       font;    setStyleHint() can be used to offer more general help
  153.       to the font matching algorithm, and on X11 setRawMode() can
  154.       be used to bypass the    entire font matching and use an    X11
  155.       XLFD.
  156.  
  157.       Of course there is also a reader function for    each of    these
  158.       set*() functions. Note that the reader functions return the
  159.       values previously set, _n_o_t the attributes of the actual
  160.       window system    font that will be used for drawing. You    can
  161.       get information about    the font that will be used for drawing
  162.       by using QFontInfo, but be aware that    QFontInfo may be slow
  163.       and that its results depend on what fonts are    installed.
  164.  
  165.       In general font handling and loading are costly operations,
  166.       especially on    X11. The QFont class contains extensive
  167.       optimizations    to make    copying    of QFont objects fast, and to
  168.       cache    the results of the slow    window system functions    it
  169.       uses.
  170.  
  171.       QFont    also offers a few static functions, mostly to tune the
  172.       font matching    algorithm: You can control what    happens    if a
  173.       font's family    isn't installed    using insertSubstitution() and
  174.       removeSubstitution(),    ask what happens for a single family
  175.       uing substitute() and    you can    get a complete list of the
  176.       fallback families using listSubstitutions().
  177.  
  178.       cacheStatistics() offers cache effectiveness information;
  179.       this is useful mostly    for debugging.
  180.  
  181.       Finally, setDefaultFont() allows you to set the default
  182.       font.    The default default font is chosen at application
  183.       startup from a set of    common installed fonts that support
  184.       the correct character    set. Of    course,    the initialization
  185.       algorithm has    a default, too:    The default default default
  186.       font!
  187.  
  188.       For more general information on fonts, see the Internet Font
  189.       Archive and in particular its    extensive FAQs:
  190.  
  191.       Questions about fonts    in general (from comp.fonts)
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 9/22/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  203.  
  204.  
  205.  
  206.       Questions about the IFA and fonts on the Internet.
  207.  
  208.       See also: QFontMetrics, QFontInfo, QApplication::setFont(),
  209.       QWidget::setFont(), QPainter::setFont(), QFont::StyleHint,
  210.       QFont::CharSet and QFont::Weight.
  211.  
  212.       Examples:  grapher/grapher.cpp desktop/desktop.cpp
  213.       drawdemo/drawdemo.cpp    movies/main.cpp    picture/picture.cpp
  214.       xform/xform.cpp widgets/widgets.cpp
  215.  
  216.      MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  217.      QQQQFFFFoooonnnntttt::::::::QQQQFFFFoooonnnntttt (((())))
  218.       Constructs a font object that    refers to the default font.
  219.  
  220.      QQQQFFFFoooonnnntttt::::::::QQQQFFFFoooonnnntttt (((( ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt    &&&& ffffoooonnnntttt ))))
  221.       Constructs a font that is a copy of _f_o_n_t.
  222.  
  223.      QQQQFFFFoooonnnntttt::::::::QQQQFFFFoooonnnntttt (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffaaaammmmiiiillllyyyy,,,, iiiinnnntttt ppppooooiiiinnnnttttSSSSiiiizzzzeeee ==== 11112222,,,, iiiinnnntttt
  224.       wwwweeeeiiiigggghhhhtttt ==== NNNNoooorrrrmmmmaaaallll,,,, bbbboooooooollll    iiiittttaaaalllliiiicccc ==== FFFFAAAALLLLSSSSEEEE ))))
  225.       Constructs a font object with    the specified _f_a_m_i_l_y,
  226.       _p_o_i_n_t_S_i_z_e, _w_e_i_g_h_t and    _i_t_a_l_i_c settings. The character set is
  227.       copied from the default font and the rest of the settings
  228.       ser set reasonably.
  229.  
  230.       If _p_o_i_n_t_S_i_z_e is less than or equal to    0 it is    set to 1.
  231.  
  232.       See also: setFamily(), setPointSize(), setWeight() and
  233.       setItalic().
  234.  
  235.      QQQQFFFFoooonnnntttt::::::::QQQQFFFFoooonnnntttt (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffaaaammmmiiiillllyyyy,,,, iiiinnnntttt ppppooooiiiinnnnttttSSSSiiiizzzzeeee,,,,    iiiinnnntttt wwwweeeeiiiigggghhhhtttt,,,,
  236.       bbbboooooooollll iiiittttaaaalllliiiicccc,,,, CCCChhhhaaaarrrrSSSSeeeetttt cccchhhhaaaarrrrSSSSeeeetttt ))))
  237.       Constructs a font object with    the specified _f_a_m_i_l_y,
  238.       _p_o_i_n_t_S_i_z_e, _w_e_i_g_h_t, _i_t_a_l_i_c and    _c_h_a_r_S_e_t    settings. If _p_o_i_n_t_S_i_z_e
  239.       is less than or equal    to 0 it    is set to 1.
  240.  
  241.       See also: setFamily(), setPointSize(), setWeight() and
  242.       setItalic().
  243.  
  244.      QQQQFFFFoooonnnntttt::::::::~~~~QQQQFFFFoooonnnntttt (((()))) [[[[vvvviiiirrrrttttuuuuaaaallll]]]]
  245.       Destroys the font object.
  246.  
  247.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::bbbboooolllldddd (((()))) ccccoooonnnnsssstttt
  248.       Returns TRUE if weight() is a    value greater than
  249.       QFont::Normal, otherwise FALSE.
  250.  
  251.       See also: weight(), setBold()    and QFontInfo::bold().
  252.  
  253.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::ccccaaaacccchhhheeeeSSSSttttaaaattttiiiissssttttiiiiccccssss (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  254.       Internal function that dumps font cache statistics.
  255.  
  256.      QQQQFFFFoooonnnntttt::::::::CCCChhhhaaaarrrrSSSSeeeetttt QQQQFFFFoooonnnntttt::::::::cccchhhhaaaarrrrSSSSeeeetttt(((()))) ccccoooonnnnsssstttt
  257.       Returns the character    set by setCharSet().
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 9/22/98)
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  269.  
  270.  
  271.  
  272.       Use QFontInfo    to find    the CharSet of the window system font
  273.       actually used.
  274.  
  275.       See also: setCharSet().
  276.  
  277.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::cccclllleeeeaaaannnnuuuupppp (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  278.       Internal function that cleans    up the font system.
  279.  
  280.      iiiinnnntttt QQQQFFFFoooonnnntttt::::::::ddddeeeecccciiiiPPPPooooiiiinnnnttttSSSSiiiizzzzeeee (((()))) ccccoooonnnnsssstttt [[[[pppprrrrooootttteeeecccctttteeeedddd]]]]
  281.       Returns the point size in 1/10ths of a point.
  282.  
  283.       See also: pointSize().
  284.  
  285.      QQQQSSSSttttrrrriiiinnnngggg QQQQFFFFoooonnnntttt::::::::ddddeeeeffffaaaauuuullllttttFFFFaaaammmmiiiillllyyyy (((()))) ccccoooonnnnsssstttt [[[[pppprrrrooootttteeeecccctttteeeedddd]]]]
  286.       Returns the family name that corresponds to the current
  287.       style    hint.
  288.  
  289.      ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& QQQQFFFFoooonnnntttt::::::::ddddeeeeffffaaaauuuullllttttFFFFoooonnnntttt (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  290.       Returns the system default font.
  291.  
  292.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::ddddiiiirrrrttttyyyy (((()))) ccccoooonnnnsssstttt    [[[[pppprrrrooootttteeeecccctttteeeedddd]]]]
  293.       Returns TRUE if the font attributes have been    changed    and
  294.       the font has to be (re)loaded, or FALSE if no    changes    have
  295.       been made.
  296.  
  297.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::eeeexxxxaaaaccccttttMMMMaaaattttcccchhhh (((()))) ccccoooonnnnsssstttt
  298.       Returns TRUE if a window system font exactly matching    the
  299.       settings of this font    is available.
  300.  
  301.       See also: QFontInfo and font matching
  302.  
  303.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQFFFFoooonnnntttt::::::::ffffaaaammmmiiiillllyyyy    (((()))) ccccoooonnnnsssstttt
  304.       Returns the family name set by setFamily().
  305.  
  306.       Use QFontInfo    to find    the family name    of the window system
  307.       font that is actually    used for drawing.
  308.  
  309.       Example:
  310.  
  311.           QFont    font( "Nairobi"    );
  312.           QFontInfo    info( font );
  313.           debug( "Font family requested is      : \"%s\"", font.family() );
  314.           debug( "Font family actually used    is: \"%s\"", info.family() );
  315.  
  316.       See also: setFamily()    and substitute().
  317.  
  318.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::ffffiiiixxxxeeeeddddPPPPiiiittttcccchhhh (((()))) ccccoooonnnnsssstttt
  319.       Returns the value set    by setFixedPitch().
  320.  
  321.       Use QFontInfo    to find    the fixed pitch    value of the window
  322.       system font actually used.
  323.  
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 9/22/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  335.  
  336.  
  337.  
  338.       See also: setFixedPitch() and    QFontInfo::fixedPitch().
  339.  
  340.      HHHHAAAANNNNDDDDLLLLEEEE QQQQFFFFoooonnnntttt::::::::hhhhaaaannnnddddlllleeee (((( HHHHAAAANNNNDDDDLLLLEEEE====0000 )))) ccccoooonnnnsssstttt
  341.       Returns the window system handle to the font,    for low-level
  342.       access. _U_s_i_n_g    _t_h_i_s _f_u_n_c_t_i_o_n _i_s _n_o_t _p_o_r_t_a_b_l_e.
  343.  
  344.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::iiiinnnniiiittttiiiiaaaalllliiiizzzzeeee (((()))) [[[[ssssttttaaaattttiiiicccc]]]]
  345.       Internal function that initializes the font system.
  346.  
  347.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::iiiinnnnsssseeeerrrrttttSSSSuuuubbbbssssttttiiiittttuuuuttttiiiioooonnnn (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffaaaammmmiiiillllyyyyNNNNaaaammmmeeee,,,, ccccoooonnnnsssstttt
  348.       cccchhhhaaaarrrr **** rrrreeeeppppllllaaaacccceeeemmmmeeeennnnttttNNNNaaaammmmeeee )))) [[[[ssssttttaaaattttiiiicccc]]]]
  349.       Inserts a new    font family name substitution in the family
  350.       substitution table.
  351.  
  352.       If _f_a_m_i_l_y_N_a_m_e    already    exists in the substitution table, it
  353.       will be replaced with    this new substitution.
  354.  
  355.       See also: removeSubstitution(), listSubstitutions() and
  356.       substitute().
  357.  
  358.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::iiiissssCCCCooooppppyyyyOOOOffff (((( ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt    &&&& ffff )))) ccccoooonnnnsssstttt
  359.       Returns TRUE if this font and    _f are copies of    each other,
  360.       ie. one of them was created as a copy    of the other and
  361.       neither was subsequently modified. This is much stricter
  362.       than equality.
  363.  
  364.       See also: operator= and operator==.
  365.  
  366.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::iiiittttaaaalllliiiicccc    (((()))) ccccoooonnnnsssstttt
  367.       Returns the value set    by setItalic().
  368.  
  369.       Use QFontInfo    to find    the italic value of the    window system
  370.       font actually    used.
  371.  
  372.       See also: setItalic().
  373.  
  374.      QQQQSSSSttttrrrriiiinnnngggg QQQQFFFFoooonnnntttt::::::::kkkkeeeeyyyy    (((()))) ccccoooonnnnsssstttt
  375.       Returns the font's key, which    is a textual representation of
  376.       the font settings. It    is typically used to insert and    find
  377.       fonts    in a dictionary    or a cache.
  378.  
  379.       See also: QDict and QCache.
  380.  
  381.      QQQQSSSSttttrrrriiiinnnngggg QQQQFFFFoooonnnntttt::::::::llllaaaassssttttRRRReeeessssoooorrrrttttFFFFaaaammmmiiiillllyyyy (((())))    ccccoooonnnnsssstttt [[[[pppprrrrooootttteeeecccctttteeeedddd]]]]
  382.       Returns a last resort    family name for    the font matching
  383.       algorithm.
  384.  
  385.       See also: lastResortFont().
  386.  
  387.      QQQQSSSSttttrrrriiiinnnngggg QQQQFFFFoooonnnntttt::::::::llllaaaassssttttRRRReeeessssoooorrrrttttFFFFoooonnnntttt (((()))) ccccoooonnnnsssstttt [[[[pppprrrrooootttteeeecccctttteeeedddd]]]]
  388.       Returns a last resort    raw font name for the font matching
  389.       algorithm.
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 9/22/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  401.  
  402.  
  403.  
  404.       This is used if not even the last resort family is
  405.       available.
  406.  
  407.       See also: lastResortFamily().
  408.  
  409.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::lllliiiissssttttSSSSuuuubbbbssssttttiiiittttuuuuttttiiiioooonnnnssss (((( QQQQSSSSttttrrrrLLLLiiiisssstttt ****    lllliiiisssstttt )))) [[[[ssssttttaaaattttiiiicccc]]]]
  410.       Returns a sorted list    of substituted family names in _l_i_s_t.
  411.  
  412.       See also: insertSubstitution(), removeSubstitution() and
  413.       substitute().
  414.  
  415.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::ooooppppeeeerrrraaaattttoooorrrr!!!!==== (((( ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& ffff ))))    ccccoooonnnnsssstttt
  416.       Returns TRUE if the this font    is different from _f, or    FALSE
  417.       if they are equal.
  418.  
  419.       Two QFonts are different if their font attributes are
  420.       different. If    raw mode is enabled for    both fonts, then only
  421.       the family fields are    compared.
  422.  
  423.       See also: operator==().
  424.  
  425.      QQQQFFFFoooonnnntttt &&&& QQQQFFFFoooonnnntttt::::::::ooooppppeeeerrrraaaattttoooorrrr==== ((((    ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& ffffoooonnnntttt ))))
  426.       Assigns _f_o_n_t to this font and    returns    a reference to this
  427.       font.
  428.  
  429.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::ooooppppeeeerrrraaaattttoooorrrr======== (((( ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& ffff ))))    ccccoooonnnnsssstttt
  430.       Returns TRUE if the this font    is equal to _f, or FALSE    if
  431.       they are different.
  432.  
  433.       Two QFonts are equal if their    font attributes    are equal. If
  434.       raw mode is enabled for both fonts, then only    the family
  435.       fields are compared.
  436.  
  437.       See also: operator!=().
  438.  
  439.      iiiinnnntttt QQQQFFFFoooonnnntttt::::::::ppppooooiiiinnnnttttSSSSiiiizzzzeeee (((()))) ccccoooonnnnsssstttt
  440.       Returns the point size set by    setPointSize().
  441.  
  442.       Use QFontInfo    to find    the point size of the window system
  443.       font actually    used.
  444.  
  445.       Example of use:
  446.  
  447.           QFont    font( "helvetica" );
  448.           QFontInfo    info( font );
  449.           font.setPointSize( 53 );
  450.           debug( "Font size    requested is    : %d", font.pointSize()    );
  451.           debug( "Font size    actually used is: %d", info.pointSize()    );
  452.  
  453.       See also: setPointSize() and deciPointSize().
  454.  
  455.       Examples:  xform/xform.cpp
  456.  
  457.  
  458.  
  459.      Page 7                         (printed 9/22/98)
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  467.  
  468.  
  469.  
  470.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::rrrraaaawwwwMMMMooooddddeeee (((()))) ccccoooonnnnsssstttt
  471.       Returns the value set    by setRawMode().
  472.  
  473.       See also: setRawMode().
  474.  
  475.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::rrrreeeemmmmoooovvvveeeeSSSSuuuubbbbssssttttiiiittttuuuuttttiiiioooonnnn (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffaaaammmmiiiillllyyyyNNNNaaaammmmeeee ))))
  476.       [[[[ssssttttaaaattttiiiicccc]]]]
  477.       Removes a font family    name substitution from the family
  478.       substitution table.
  479.  
  480.       See also: insertSubstitution(), listSubstitutions() and
  481.       substitute().
  482.  
  483.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttBBBBoooolllldddd (((( bbbboooooooollll    eeeennnnaaaabbbblllleeee ))))
  484.       Sets the weight to QFont::Bold if _e_n_a_b_l_e is TRUE, or to
  485.       QFont::Normal    if _e_n_a_b_l_e is FALSE.
  486.  
  487.       Use setWeight() to set the weight to other values.
  488.  
  489.       See also: bold() and setWeight().
  490.  
  491.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttCCCChhhhaaaarrrrSSSSeeeetttt (((( CCCChhhhaaaarrrrSSSSeeeetttt cccchhhhaaaarrrrsssseeeetttt ))))
  492.       Sets the character set encoding (e.g.    Latin1).
  493.  
  494.       If the character set encoding    is not available another will
  495.       be used for drawing. for most    non-trivial applications you
  496.       will probably    not want this to happen    since it can totally
  497.       obscure the text shown to the    user. This is why the font
  498.       matching algorithm gives high    priority to finding the
  499.       correct character set.
  500.  
  501.       You can test that the    character set is correct using the
  502.       QFontInfo class.
  503.  
  504.       Example:
  505.  
  506.           QFont    font( "times", 14 );           // default character set    is Latin1
  507.           QFontInfo    info( font );
  508.           if ( info.charSet() != Latin1 )           // check    actual font
  509.           fatal( "Cannot find a    Latin 1    Times font" );
  510.  
  511.       In Qt    1.40, the following character set encodings are
  512.       available:
  513.  
  514.       QFont::Latin1    - ISO 8859-1, common in    much of    Europe
  515.  
  516.       QFont::Latin2    - ISO 8859-
  517.            2, less common European character set
  518.  
  519.       QFont::Latin3    - ISO 8859-
  520.            3, less common European character set
  521.  
  522.  
  523.  
  524.  
  525.      Page 8                         (printed 9/22/98)
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  533.  
  534.  
  535.  
  536.       QFont::Latin4    - ISO 8859-
  537.            4, less common European character set
  538.  
  539.       QFont::Latin5    - ISO 8859-5, Cyrillic
  540.  
  541.       QFont::Latin6    - ISO 8859-6, Arabic
  542.  
  543.       QFont::Latin7    - ISO 8859-7, Greek
  544.  
  545.       QFont::Latin8    - ISO 8859-8, Hebrew
  546.  
  547.       QFont::Latin9    - ISO 8859-
  548.            9, less common European character set
  549.  
  550.       QFont::KOI8R - KOI8-R, Cyrillic, defined in RFC 1489.
  551.  
  552.       QFont::AnyCharSet - whatever is handiest.
  553.  
  554.       See also: charSet(), QFontInfo and font matching
  555.  
  556.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttDDDDeeeeffffaaaauuuullllttttFFFFoooonnnntttt    (((( ccccoooonnnnsssstttt    QQQQFFFFoooonnnntttt &&&&    ffff )))) [[[[ssssttttaaaattttiiiicccc]]]]
  557.       Sets the system default font.
  558.  
  559.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttFFFFaaaammmmiiiillllyyyy (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ffffaaaammmmiiiillllyyyy ))))
  560.       Sets the family name of the font (e.g. "Helvetica" or
  561.       "times").
  562.  
  563.       The family name is case insensitive.
  564.  
  565.       If the family    is not available a default family is used.
  566.  
  567.       See also: family(), setStyleHint(), QFontInfo    and font
  568.       matching
  569.  
  570.       Examples:  xform/xform.cpp
  571.  
  572.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttFFFFiiiixxxxeeeeddddPPPPiiiittttcccchhhh (((( bbbboooooooollll eeeennnnaaaabbbblllleeee ))))
  573.       Sets fixed pitch on or off.
  574.  
  575.       A fixed pitch    font is    a font where all characters have the
  576.       same width.
  577.  
  578.       See also: fixedPitch(), QFontInfo and    font matching
  579.  
  580.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttIIIIttttaaaalllliiiicccc (((( bbbboooooooollll eeeennnnaaaabbbblllleeee ))))
  581.       Sets italic on or off.
  582.  
  583.       See also: italic(), QFontInfo    and font matching
  584.  
  585.       Examples:  xform/xform.cpp
  586.  
  587.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttPPPPooooiiiinnnnttttSSSSiiiizzzzeeee ((((    iiiinnnntttt ppppooooiiiinnnnttttSSSSiiiizzzzeeee ))))
  588.  
  589.  
  590.  
  591.      PPPPaaaaggggeeee 9999                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  599.  
  600.  
  601.  
  602.       Sets the point size to _p_o_i_n_t_S_i_z_e. The    point size must    be
  603.       greater than zero.
  604.  
  605.       Example:
  606.  
  607.           QFont font( "courier" );
  608.           font.setPointSize( 18 );
  609.  
  610.       See also: pointSize(), QFontInfo and font matching
  611.  
  612.       Examples:  xform/xform.cpp
  613.  
  614.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttRRRRaaaawwwwMMMMooooddddeeee (((( bbbboooooooollll eeeennnnaaaabbbblllleeee ))))
  615.       Turns    raw mode on if _e_n_a_b_l_e is TRUE, or turns    it off if
  616.       _e_n_a_b_l_e is FALSE.
  617.  
  618.       Calling this function    only has effect    under X    windows. If
  619.       raw mode is enabled, Qt will search for an X font with a
  620.       complete font    name matching the family name, ignoring    all
  621.       other    values set for the QFont. If the font name matches
  622.       several fonts, Qt will use the first font returned by    X.
  623.       QFontInfo _c_a_n_n_o_t be used to fetch information    about a    QFont
  624.       using    raw mode (it will return the values set    in the QFont
  625.       for all parameters, including    the family name).
  626.  
  627.       Example:
  628.  
  629.           #if defined(_WS_X11_)
  630.           QFont    font( "-*-fixed-*-*-*-*-*-140-75-75-c-*-iso8859-1" );
  631.           font.setRawMode( TRUE    );
  632.           if ( !font.exactMatch() )
  633.               fatal( "Sorry, could not find the    X specific font" );
  634.           #endif
  635.  
  636.       WWWWaaaarrrrnnnniiiinnnngggg:::: Do not use raw mode unless you really need it!
  637.  
  638.       See also: rawMode().
  639.  
  640.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttSSSSttttrrrriiiikkkkeeeeOOOOuuuutttt ((((    bbbboooooooollll eeeennnnaaaabbbblllleeee ))))
  641.       Sets strike out on or    off.
  642.  
  643.       See also: strikeOut(), QFontInfo and font matching
  644.  
  645.       Examples:  xform/xform.cpp
  646.  
  647.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttSSSSttttyyyylllleeeeHHHHiiiinnnntttt ((((    SSSSttttyyyylllleeeeHHHHiiiinnnntttt hhhhiiiinnnntttt ))))
  648.       Sets the style hint.
  649.  
  650.       The style hint is used by the    font matching algorithm    when a
  651.       selected font    family cannot be found and is used to find an
  652.       appropriate default family.
  653.  
  654.  
  655.  
  656.  
  657.      Page 10                         (printed 9/22/98)
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  665.  
  666.  
  667.  
  668.       The style hint has a default value of    AnyStyle which leaves
  669.       the task of finding a    good default family to the font
  670.       matching algorithm.
  671.  
  672.       In this example (which is a complete program)    the push
  673.       button will display its text label with the Bavaria font
  674.       family if this family    is available, if not it    will display
  675.       its text label with another serif font:
  676.  
  677.           #include <qapplication.h>
  678.           #include <qpushbutton.h>
  679.           #include <qfont.h>
  680.           int main(    int argc, char **argv )
  681.           {
  682.           QApplication app( argc, argv );
  683.           QPushButton  push("Push me");
  684.           QFont    font( "Bavaria", 18 );          // preferrred family is Bavaria
  685.           font.setStyleHint( QFont::Serif );  // can also use any serif    font
  686.           push.setFont(    font );
  687.           return app.exec( &push );
  688.           }
  689.  
  690.       The other available style hints are QFont::SansSerif,
  691.       QFont::TypeWriter, QFont::OldEnglish,    QFont::System
  692.  
  693.       See also: styleHint(), QFontInfo and font matching
  694.  
  695.       Examples:  desktop/desktop.cpp
  696.  
  697.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttUUUUnnnnddddeeeerrrrlllliiiinnnneeee ((((    bbbboooooooollll eeeennnnaaaabbbblllleeee ))))
  698.       Sets underline on or off.
  699.  
  700.       See also: underline(), QFontInfo and font matching.
  701.  
  702.       Examples:  xform/xform.cpp
  703.  
  704.      vvvvooooiiiidddd QQQQFFFFoooonnnntttt::::::::sssseeeettttWWWWeeeeiiiigggghhhhtttt (((( iiiinnnntttt wwwweeeeiiiigggghhhhtttt    ))))
  705.       Sets the weight (or boldness).
  706.  
  707.       The enum QFont::Weight contains the predefined font weights:
  708.  
  709.       QFont::Light (25)
  710.  
  711.       QFont::Normal    (50)
  712.  
  713.       QFont::DemiBold (63)
  714.  
  715.       QFont::Bold (75)
  716.  
  717.       QFont::Black (87)
  718.  
  719.       Strictly speaking you    can use    all values in the range    [0,99]
  720.  
  721.  
  722.  
  723.      Page 11                         (printed 9/22/98)
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  731.  
  732.  
  733.  
  734.       (where 0 is ultralight and 99    is extremely black), but there
  735.       is such a thing as asking too    much of    the underlying window
  736.       system.
  737.  
  738.       Example:
  739.  
  740.           QFont font( "courier" );
  741.           font.setWeight( QFont::Bold );
  742.  
  743.       If the specified weight is not available the closest
  744.       available will be used. Use QFontInfo    to check the actual
  745.       weight.
  746.  
  747.       See also: weight(), QFontInfo    and font matching
  748.  
  749.       Examples:  xform/xform.cpp
  750.  
  751.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::ssssttttrrrriiiikkkkeeeeOOOOuuuutttt (((()))) ccccoooonnnnsssstttt
  752.       Returns the value set    by setStrikeOut().
  753.  
  754.       Use QFontInfo    to find    the strike out value of    the window
  755.       system font actually used.
  756.  
  757.       See also: setStrikeOut() and QFontInfo::strikeOut().
  758.  
  759.      QQQQFFFFoooonnnntttt::::::::SSSSttttyyyylllleeeeHHHHiiiinnnntttt QQQQFFFFoooonnnntttt::::::::ssssttttyyyylllleeeeHHHHiiiinnnntttt(((()))) ccccoooonnnnsssstttt
  760.       Returns the StyleHint    set by setStyleHint().
  761.  
  762.       See also: setStyleHint() and QFontInfo::styleHint().
  763.  
  764.      ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** QQQQFFFFoooonnnntttt::::::::ssssuuuubbbbssssttttiiiittttuuuutttteeee (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ffffaaaammmmiiiillllyyyyNNNNaaaammmmeeee ))))
  765.       [[[[ssssttttaaaattttiiiicccc]]]]
  766.       Returns the font family name to be used whenever _f_a_m_i_l_y_N_a_m_e
  767.       is specified,    and not    found by the font matching algorithm.
  768.       The lookup is    case insensitive.
  769.  
  770.       If there is no substitution for _f_a_m_i_l_y_N_a_m_e, then _f_a_m_i_l_y_N_a_m_e
  771.       is returned.
  772.  
  773.       Example:
  774.  
  775.           QFont::insertSubstitution( "NewYork", "London" );
  776.           QFont::insertSubstitution( "Paris",   "Texas" );
  777.           QFont::substitute( "NewYork" );      // returns "London"
  778.           QFont::substitute( "PARIS" );      // returns "Texas"
  779.           QFont::substitute( "Rome"    );      // returns "Rome"
  780.           QFont::removeSubstitution( "newyork" );
  781.           QFont::substitute( "NewYork" );      // returns "NewYork"
  782.  
  783.       See also: setFamily(), insertSubstitution() and
  784.       removeSubstitution().
  785.  
  786.  
  787.  
  788.  
  789.      Page 12                         (printed 9/22/98)
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.      QQQQFFFFoooonnnntttt((((3333qqqqtttt))))        TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))        QQQQFFFFoooonnnntttt((((3333qqqqtttt))))
  797.  
  798.  
  799.  
  800.      bbbboooooooollll QQQQFFFFoooonnnntttt::::::::uuuunnnnddddeeeerrrrlllliiiinnnneeee (((()))) ccccoooonnnnsssstttt
  801.       Returns the value set    by setUnderline().
  802.  
  803.       Use QFontInfo    to find    the underline value of the window
  804.       system font actually used for    drawing.
  805.  
  806.       See also: setUnderline() and QFontInfo::underline().
  807.  
  808.      iiiinnnntttt QQQQFFFFoooonnnntttt::::::::wwwweeeeiiiigggghhhhtttt (((()))) ccccoooonnnnsssstttt
  809.       Returns the weight set by setWeight().
  810.  
  811.       Use QFontInfo    to find    the weight of the window system    font
  812.       actually used.
  813.  
  814.       See also: setWeight()    and QFontInfo.
  815.  
  816.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  817.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    ccccoooonnnnsssstttt QQQQFFFFoooonnnntttt &&&& ffff))))
  818.       Writes a font    to the stream.
  819.  
  820.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    QQQQFFFFoooonnnntttt &&&&    ffff))))
  821.       Reads    a font from the    stream.
  822.  
  823.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  824.       hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqffffoooonnnntttt....hhhhttttmmmmllll
  825.  
  826.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  827.       Copyright 1992-1997 Troll Tech AS.  See the LICENSE file
  828.       included in the distribution for a complete license
  829.       statement.
  830.  
  831.      AAAAUUUUTTTTHHHHOOOORRRR
  832.       Generated automatically from the source code.
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.      Page 13                         (printed 9/22/98)
  856.  
  857.  
  858.  
  859.